curl --request GET \
--url https://sandbox.prezio.eu/api/tariffs/{id}/ \
--header 'Authorization: <api-key>'
{
"id": "tar_45",
"name": "Advanced Business Tariff",
"has_time_of_use": true,
"has_tiers": true,
"has_calculation_input": true,
"has_properties": true,
"context": {
"country": {
"code": "DK",
"timezone_default": "Europe/Copenhagen",
"currency": "DKK"
},
"organization": {
"id": "org_285",
"name": "Copenhagen DSO",
"type": "DSO"
},
"consumer_types": [
"BUSINESS",
"RESIDENTIAL"
],
"main_tariff": {
"id": "mta_33",
"name": "Advanced Pricing",
"description": "Time-variable pricing with demand components"
}
},
"tariff_properties": [
{
"id": "pro_15",
"key": "contract_type",
"name": "Contract Type",
"data_type": "CHOICE",
"group_key": "tariff_type",
"group_name": "Tariff Type",
"question": "What type of electricity contract do you prefer?",
"description": "Different pricing structures available",
"choices": [
{
"id": "prv_13",
"name": "Spot",
"value": "spot"
}
]
},
{
"id": "pro_16",
"key": "price_duration",
"name": "Price Variability Duration",
"data_type": "CHOICE",
"group_key": "tariff_type",
"group_name": "Tariff Type",
"question": "How often do you want price updates?",
"description": "Frequency of price changes",
"choices": [
{
"id": "prv_41",
"name": "Hourly",
"value": "1h"
}
]
}
],
"tou_levels": [
{
"id": "tou_146",
"name": "Peak",
"type": "ON_PEAK",
"periods": [
{
"from_time": "17:00",
"to_time": "20:59",
"from_day": 1,
"to_day": 5,
"summary": "Mon-Fri: 17:00-20:59"
}
]
},
{
"id": "tou_162",
"name": "Partial peak",
"type": "PARTIAL_PEAK",
"periods": [
{
"from_time": "05:00",
"to_time": "16:59",
"from_day": 1,
"to_day": 5,
"summary": "Mon-Fri: 05:00-16:59"
},
{
"from_time": "21:00",
"to_time": "23:59",
"from_day": 1,
"to_day": 5,
"summary": "Mon-Fri: 21:00-23:59"
}
]
},
{
"id": "tou_145",
"name": "Off-peak",
"type": "OFF_PEAK",
"periods": [
{
"from_time": "00:00",
"to_time": "04:59",
"from_day": 1,
"to_day": 0,
"summary": "Mon-Sun: 00:00-04:59"
}
]
}
],
"components": [
{
"id": "com_1889",
"name": "TOU Demand",
"key": "tou_demand",
"description": "Time-of-use demand charge",
"type": "DEMAND",
"unit": "kw_per_month",
"direction": "IMP",
"has_time_of_use": true,
"has_tiers": false,
"has_calculation_input": true,
"has_properties": false,
"applicable_vat_rate": "standard",
"from": "2025-01-01T00:00:00+01:00",
"to": "2025-12-31T23:59:59+01:00",
"calculation_requirements": [
{
"type": "CALCULATION_INPUT",
"key": "peak_demand",
"name": "Peak Demand",
"input_unit": "KW",
"input_period": "MONTH",
"choices": [
{
"key": "peak_demand_single",
"type": "SINGLE_VALUE"
}
]
},
{
"type": "TOU_LEVEL",
"key": "tou",
"name": "Time of Use Level",
"choices": [
{
"id": "tou_146",
"type": "ON_PEAK"
},
{
"id": "tou_162",
"type": "PARTIAL_PEAK"
},
{
"id": "tou_145",
"type": "OFF_PEAK"
}
]
}
]
},
{
"id": "com_15555",
"name": "Energy Consumption (kWh)",
"key": "kwh",
"description": "Variable energy consumption charge",
"type": "KWH",
"unit": "kwh",
"direction": "IMP",
"has_time_of_use": true,
"has_tiers": false,
"has_calculation_input": true,
"has_properties": true,
"applicable_vat_rate": "standard",
"from": "2025-01-01T00:00:00+01:00",
"to": null,
"calculation_requirements": [
{
"type": "CALCULATION_INPUT",
"key": "consumption",
"name": "Energy Consumption (kWh)",
"input_unit": "KWH",
"input_period": null,
"choices": [
{
"key": "consumption_profile",
"type": "TIME_SERIES"
},
{
"key": "consumption_total",
"type": "SINGLE_VALUE"
}
]
},
{
"type": "TOU_LEVEL",
"key": "tou",
"name": "Time of Use Level",
"choices": [
{
"id": "tou_146",
"type": "ON_PEAK"
},
{
"id": "tou_162",
"type": "PARTIAL_PEAK"
},
{
"id": "tou_145",
"type": "OFF_PEAK"
}
]
}
]
},
{
"id": "com_15552",
"name": "Capacity Fuses",
"key": "capacity_fuses",
"description": "Fixed charge based on fuse level",
"type": "FIXED",
"unit": "per_month",
"direction": "IMP",
"has_time_of_use": false,
"has_tiers": false,
"has_calculation_input": false,
"has_properties": true,
"applicable_vat_rate": "standard",
"from": "2025-01-01T00:00:00+01:00",
"to": null,
"calculation_requirements": [
{
"type": "PRICE_PROPERTY",
"key": "fuse_level",
"name": "Fuse Level",
"data_type": "CHOICE",
"choices": [
"16",
"20",
"25"
]
}
]
},
{
"id": "com_15551",
"name": "Energy Tax",
"key": "energy_tax",
"description": "Government energy tax",
"type": "TAX",
"unit": "percent",
"direction": "IMP",
"has_time_of_use": false,
"has_tiers": false,
"has_calculation_input": false,
"has_properties": false,
"applicable_vat_rate": "standard",
"from": "2025-07-01T00:00:00+02:00",
"to": null
}
]
}
Returns comprehensive information about a specific tariff including its components, properties, and pricing structure.
Required: id
is required.
Key Features:
Use Cases:
This endpoint is currently in beta. Errors may happen. Changes may occur.
curl --request GET \
--url https://sandbox.prezio.eu/api/tariffs/{id}/ \
--header 'Authorization: <api-key>'
{
"id": "tar_45",
"name": "Advanced Business Tariff",
"has_time_of_use": true,
"has_tiers": true,
"has_calculation_input": true,
"has_properties": true,
"context": {
"country": {
"code": "DK",
"timezone_default": "Europe/Copenhagen",
"currency": "DKK"
},
"organization": {
"id": "org_285",
"name": "Copenhagen DSO",
"type": "DSO"
},
"consumer_types": [
"BUSINESS",
"RESIDENTIAL"
],
"main_tariff": {
"id": "mta_33",
"name": "Advanced Pricing",
"description": "Time-variable pricing with demand components"
}
},
"tariff_properties": [
{
"id": "pro_15",
"key": "contract_type",
"name": "Contract Type",
"data_type": "CHOICE",
"group_key": "tariff_type",
"group_name": "Tariff Type",
"question": "What type of electricity contract do you prefer?",
"description": "Different pricing structures available",
"choices": [
{
"id": "prv_13",
"name": "Spot",
"value": "spot"
}
]
},
{
"id": "pro_16",
"key": "price_duration",
"name": "Price Variability Duration",
"data_type": "CHOICE",
"group_key": "tariff_type",
"group_name": "Tariff Type",
"question": "How often do you want price updates?",
"description": "Frequency of price changes",
"choices": [
{
"id": "prv_41",
"name": "Hourly",
"value": "1h"
}
]
}
],
"tou_levels": [
{
"id": "tou_146",
"name": "Peak",
"type": "ON_PEAK",
"periods": [
{
"from_time": "17:00",
"to_time": "20:59",
"from_day": 1,
"to_day": 5,
"summary": "Mon-Fri: 17:00-20:59"
}
]
},
{
"id": "tou_162",
"name": "Partial peak",
"type": "PARTIAL_PEAK",
"periods": [
{
"from_time": "05:00",
"to_time": "16:59",
"from_day": 1,
"to_day": 5,
"summary": "Mon-Fri: 05:00-16:59"
},
{
"from_time": "21:00",
"to_time": "23:59",
"from_day": 1,
"to_day": 5,
"summary": "Mon-Fri: 21:00-23:59"
}
]
},
{
"id": "tou_145",
"name": "Off-peak",
"type": "OFF_PEAK",
"periods": [
{
"from_time": "00:00",
"to_time": "04:59",
"from_day": 1,
"to_day": 0,
"summary": "Mon-Sun: 00:00-04:59"
}
]
}
],
"components": [
{
"id": "com_1889",
"name": "TOU Demand",
"key": "tou_demand",
"description": "Time-of-use demand charge",
"type": "DEMAND",
"unit": "kw_per_month",
"direction": "IMP",
"has_time_of_use": true,
"has_tiers": false,
"has_calculation_input": true,
"has_properties": false,
"applicable_vat_rate": "standard",
"from": "2025-01-01T00:00:00+01:00",
"to": "2025-12-31T23:59:59+01:00",
"calculation_requirements": [
{
"type": "CALCULATION_INPUT",
"key": "peak_demand",
"name": "Peak Demand",
"input_unit": "KW",
"input_period": "MONTH",
"choices": [
{
"key": "peak_demand_single",
"type": "SINGLE_VALUE"
}
]
},
{
"type": "TOU_LEVEL",
"key": "tou",
"name": "Time of Use Level",
"choices": [
{
"id": "tou_146",
"type": "ON_PEAK"
},
{
"id": "tou_162",
"type": "PARTIAL_PEAK"
},
{
"id": "tou_145",
"type": "OFF_PEAK"
}
]
}
]
},
{
"id": "com_15555",
"name": "Energy Consumption (kWh)",
"key": "kwh",
"description": "Variable energy consumption charge",
"type": "KWH",
"unit": "kwh",
"direction": "IMP",
"has_time_of_use": true,
"has_tiers": false,
"has_calculation_input": true,
"has_properties": true,
"applicable_vat_rate": "standard",
"from": "2025-01-01T00:00:00+01:00",
"to": null,
"calculation_requirements": [
{
"type": "CALCULATION_INPUT",
"key": "consumption",
"name": "Energy Consumption (kWh)",
"input_unit": "KWH",
"input_period": null,
"choices": [
{
"key": "consumption_profile",
"type": "TIME_SERIES"
},
{
"key": "consumption_total",
"type": "SINGLE_VALUE"
}
]
},
{
"type": "TOU_LEVEL",
"key": "tou",
"name": "Time of Use Level",
"choices": [
{
"id": "tou_146",
"type": "ON_PEAK"
},
{
"id": "tou_162",
"type": "PARTIAL_PEAK"
},
{
"id": "tou_145",
"type": "OFF_PEAK"
}
]
}
]
},
{
"id": "com_15552",
"name": "Capacity Fuses",
"key": "capacity_fuses",
"description": "Fixed charge based on fuse level",
"type": "FIXED",
"unit": "per_month",
"direction": "IMP",
"has_time_of_use": false,
"has_tiers": false,
"has_calculation_input": false,
"has_properties": true,
"applicable_vat_rate": "standard",
"from": "2025-01-01T00:00:00+01:00",
"to": null,
"calculation_requirements": [
{
"type": "PRICE_PROPERTY",
"key": "fuse_level",
"name": "Fuse Level",
"data_type": "CHOICE",
"choices": [
"16",
"20",
"25"
]
}
]
},
{
"id": "com_15551",
"name": "Energy Tax",
"key": "energy_tax",
"description": "Government energy tax",
"type": "TAX",
"unit": "percent",
"direction": "IMP",
"has_time_of_use": false,
"has_tiers": false,
"has_calculation_input": false,
"has_properties": false,
"applicable_vat_rate": "standard",
"from": "2025-07-01T00:00:00+02:00",
"to": null
}
]
}
Token-based authentication with required prefix "Token"
Tariff ID with "tar_" prefix or raw integer (e.g., "tar_789", "789")
Include tariff_properties (similar to the data from the list endpoint) section in response (default: false)
Include detailed information about tou_levels including periods (default: false)
Filter components to show only those with active prices at the specified datetime. Also determines the validity range shown in component 'from' and 'to' fields, and affects the calculation of tariff-level flags. Format: 'YYYY-MM-DDTHH:MM:SS' (ISO 8601). If not provided, uses current time.
Success - Returns detailed tariff information incl. advanced calculation requirements
Enhanced serializer for detailed tariff retrieval using common mixins
Was this page helpful?